home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XIconifyWindow.z / XIconifyWindow
Encoding:
Text File  |  2002-10-03  |  6.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXIIIIccccoooonnnniiiiffffyyyyWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXIIIIccccoooonnnniiiiffffyyyyWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XIconifyWindow, XWithdrawWindow, XReconfigureWMWindow -
  10.           manipulate top-level windows
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           Status XIconifyWindow(_d_i_s_p_l_a_y, _w, _s_c_r_e_e_n__n_u_m_b_e_r)
  14.                 Display *_d_i_s_p_l_a_y;
  15.                 Window _w;
  16.                 int _s_c_r_e_e_n__n_u_m_b_e_r;
  17.  
  18.           Status XWithdrawWindow(_d_i_s_p_l_a_y, _w, _s_c_r_e_e_n__n_u_m_b_e_r)
  19.                 Display *_d_i_s_p_l_a_y;
  20.                 Window _w;
  21.                 int _s_c_r_e_e_n__n_u_m_b_e_r;
  22.  
  23.           Status XReconfigureWMWindow(_d_i_s_p_l_a_y, _w, _s_c_r_e_e_n__n_u_m_b_e_r,
  24.           _v_a_l_u_e__m_a_s_k, _v_a_l_u_e_s)
  25.                 Display *_d_i_s_p_l_a_y;
  26.                 Window _w;
  27.                 int _s_c_r_e_e_n__n_u_m_b_e_r;
  28.                 unsigned int _v_a_l_u_e__m_a_s_k;
  29.                 XWindowChanges *_v_a_l_u_e_s;
  30.  
  31.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  32.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  33.  
  34.           _s_c_r_e_e_n__n_u_m_b_e_r
  35.                     Specifies the appropriate screen number on the
  36.                     host server.
  37.  
  38.           _v_a_l_u_e__m_a_s_k
  39.                     Specifies which values are to be set using
  40.                     information in the values structure.  This mask is
  41.                     the bitwise inclusive OR of the valid configure
  42.                     window values bits.
  43.  
  44.           _v_a_l_u_e_s    Specifies the _X_W_i_n_d_o_w_C_h_a_n_g_e_s structure.
  45.  
  46.           _w         Specifies the window.
  47.  
  48.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  49.           The _X_I_c_o_n_i_f_y_W_i_n_d_o_w function sends a WM_CHANGE_STATE
  50.           _C_l_i_e_n_t_M_e_s_s_a_g_e event with a format of 32 and a first data
  51.           element of _I_c_o_n_i_c_S_t_a_t_e (as described in section 4.1.4 of the
  52.           _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l) and a window
  53.           of w to the root window of the specified screen with an
  54.           event mask set to _S_u_b_s_t_r_u_c_t_u_r_e_N_o_t_i_f_y_M_a_s_k|
  55.           _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k.  Window managers may elect to
  56.           receive this message and if the window is in its normal
  57.           state, may treat it as a request to change the window's
  58.           state from normal to iconic.  If the WM_CHANGE_STATE
  59.           property cannot be interned, _X_I_c_o_n_i_f_y_W_i_n_d_o_w does not send a
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXIIIIccccoooonnnniiiiffffyyyyWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXIIIIccccoooonnnniiiiffffyyyyWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           message and returns a zero status.  It returns a nonzero
  75.           status if the client message is sent successfully;
  76.           otherwise, it returns a zero status.
  77.  
  78.           The _X_W_i_t_h_d_r_a_w_W_i_n_d_o_w function unmaps the specified window and
  79.           sends a synthetic _U_n_m_a_p_N_o_t_i_f_y event to the root window of
  80.           the specified screen.  Window managers may elect to receive
  81.           this message and may treat it as a request to change the
  82.           window's state to withdrawn.  When a window is in the
  83.           withdrawn state, neither its normal nor its iconic
  84.           representations is visible.  It returns a nonzero status if
  85.           the _U_n_m_a_p_N_o_t_i_f_y event is successfully sent; otherwise, it
  86.           returns a zero status.
  87.  
  88.           _X_W_i_t_h_d_r_a_w_W_i_n_d_o_w can generate a _B_a_d_W_i_n_d_o_w error.
  89.  
  90.           The _X_R_e_c_o_n_f_i_g_u_r_e_W_M_W_i_n_d_o_w function issues a _C_o_n_f_i_g_u_r_e_W_i_n_d_o_w
  91.           request on the specified top-level window.  If the stacking
  92.           mode is changed and the request fails with a _B_a_d_M_a_t_c_h error,
  93.           the error is trapped by Xlib and a synthetic
  94.           _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t_E_v_e_n_t containing the same configuration
  95.           parameters is sent to the root of the specified window.
  96.           Window managers may elect to receive this event and treat it
  97.           as a request to reconfigure the indicated window.  It
  98.           returns a nonzero status if the request or event is
  99.           successfully sent; otherwise, it returns a zero status.
  100.  
  101.           _X_R_e_c_o_n_f_i_g_u_r_e_W_M_W_i_n_d_o_w can generate _B_a_d_V_a_l_u_e and _B_a_d_W_i_n_d_o_w
  102.           errors.
  103.  
  104.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  105.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  106.                     values accepted by the request.  Unless a specific
  107.                     range is specified for an argument, the full range
  108.                     defined by the argument's type is accepted.  Any
  109.                     argument defined as a set of alternatives can
  110.                     generate this error.
  111.  
  112.           _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  113.                     defined Window.
  114.  
  115.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  116.           XChangeWindowAttributes(3X11), XConfigureWindow(3X11),
  117.           XCreateWindow(3X11), XDestroyWindow(3X11),
  118.           XRaiseWindow(3X11), XMapWindow(3X11), XUnmapWindow(3X11)
  119.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.